home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / fax / src / relnotes / ch2.cmm < prev    next >
Text File  |  1994-08-01  |  24KB  |  582 lines
  1. .ds FF Flex\s-1FAX\s+1
  2. .nr H1 1
  3. .H 1 "Installation Information"
  4. .\"
  5. .\"    Developer
  6. .\"
  7. This chapter lists supplemental information to 
  8. the \f2IRIS Software Installation Guide.\f1
  9. The information listed here is product-specific;
  10. use it with the Installation Guide to install 
  11. this product.
  12. .H 2 "\*(FF Subsystems"
  13. ..\"
  14. .\" Each subsystem should be described in enough detail so that
  15. .\" users can decide whether or not they need to install it.
  16. .\" Hints such as "You need to install this subsystem if you want to use
  17. .\" Visual System Administration Tools" or "This subsystem is useful only
  18. .\" if you want to display Kanji characters" would be nice. For subsystems
  19. .\" such as eoe2.sw.4Dwm that are important if you have graphics, but not 
  20. .\" important for servers and aren't marked required in the spec file (inst 
  21. .\" doesn't show + and doesn't require their installation), be sure to make
  22. .\" this very clear in the description or in a separate list.
  23. .\"
  24. The \*(FF software includes these subsystems:
  25. .VL 30
  26. .LI "\f2flexfax.sw.client\f1"
  27. Software for sending facsimile and
  28. querying the status of \*(FF servers.
  29. .LI "\f2flexfax.man.client\f1"
  30. Manual pages for client programs.
  31. .LI "\f2flexfax.sw.server\f1"
  32. Software for running a \*(FF server.
  33. .LI "\f2flexfax.man.readme\f1"
  34. Basic information about the system, including setup and maintenance.
  35. .LI "\f2flexfax.man.server\f1"
  36. Manual pages for the server software.
  37. .LI "\f2flexfax.man.relnotes\f1"
  38. Release notes (this document)
  39. .LI "\f2flexfax.man.doc\f1"
  40. Miscellaneous supporting documentation, including
  41. information about the Class 1 and Class 2 host-modem
  42. programming interfaces.
  43. .LE
  44. .H 2 "\*(FF Subsystem Disk Space Requirements"
  45. .\"
  46. .\" The size of each subsystem should be listed so that users get an idea
  47. .\" of the disk space requirements before they get into inst.
  48. .\"
  49. This section lists the subsystems (and their sizes) of the \*(FF option.
  50. .P
  51. Those marked ``default'' are the default subsystems.
  52. If you are installing this option for the first time,
  53. these are the subsystems that are installed if you
  54. use the ``go'' menu item.
  55. To install a different set of subsystems, use 
  56. the ``install,'' ``remove,'' ``keep,'' and ``step'' commands 
  57. in \f2inst\f1 to customize the list of subsystems to be
  58. installed, then select the ``go'' menu item.
  59. .VL 7
  60. .LI "\f6Note:\f1"
  61. The listed subsystem sizes are approximate. 
  62. Refer to the 
  63. \f2IRIS Software Installation Guide\f1
  64. for information on finding exact sizes.
  65. .LE
  66. .ps 9
  67. .vs 11
  68. .TS
  69. tab(:);
  70. lw(2.75i):lw(1.5i)
  71. lw(2.75i):lw(1.5i)
  72. lIw(2.75i):nw(1.5i).
  73. \f6Subsystem Name:Subsystem Size
  74. :\f6(kilobytes)\f1
  75. .ps 10
  76. .vs 12
  77. .sp 0.3
  78. flexfax.sw.client:\f11786
  79. .br
  80. \f1(default)\fP
  81. .sp 0.3
  82. flexfax.sw.server:\f12464
  83. .sp 0.3
  84. flexfax.man.client:\f138
  85. .br
  86. \f1(default)\fP
  87. .sp 0.3
  88. flexfax.man.server:\f181
  89. .sp 0.3
  90. flexfax.man.readme:\f146
  91. .br
  92. \f1(default)\fP
  93. .sp 0.3
  94. flexfax.man.relnotes:\f121
  95. .br
  96. \f1(default)\fP
  97. .sp 0.3
  98. flexfax.man.doc:\f181
  99. .TE
  100. .ps 11
  101. .vs 13
  102. .H 2 "Installation Method"
  103. All of the subsystems for \*(FF can be installed using IRIX.
  104. You do not need to use the miniroot. Refer to the \f2IRIS Software 
  105. Installation Guide\f1 for complete installation instructions.
  106. .ps 10
  107. .vs 12
  108. .H 2 "Prerequisites"
  109. .\"
  110. .\" Delete this section if it does not apply.
  111. .\"
  112. .\" Every prerequisite of every subsystem should be listed whether it's in
  113. .\" spec file or not. Be sure to include specific release numbers when
  114. .\" the prerequisite is a subsystem in a different product.  If there are
  115. .\" many prerequisites, you might want to list them in a table. 
  116. .\"
  117. .\" Examples of prerequisite information are:
  118. .\"
  119. If you want to install flexfax.sw.server, you must also install
  120. dps_eoe.sw.dps and dps_eoe.sw.dpsfonts.
  121. .\" If you want to install a.b.c, release n.0 or later of x.y.z must be
  122. .\" installed.
  123. Your workstation must be running at least release 4D1-4.0.1 in order to
  124. use version 2.2.2 of this software.
  125. Note that there are two different binary installation packages;
  126. one for IRIX 4.X systems and another for IRIX 5.X systems.
  127. If you try to run the IRIX 4.X system under IRIX 5.X the fax server
  128. will terminate prematurely.
  129. IRIX 4.X client applications work under IRIX 5.X without any problems;
  130. however it is advisable to use the IRIX 5.X binaries since they will
  131. take advantage of the IRIX 5.X DSO support.
  132. .\"
  133. .H 2 "Configuration Files"
  134. .\"
  135. .\" Delete this section if it does not apply.
  136. .\"
  137. .\" List the configuration files in your product.  Tell what their purpose
  138. .\" is and give users some idea of how and why they might want to modify them.
  139. .\" You should also discuss each of the changes made in each of the 
  140. .\" configuration files for this release to make the process of merging
  141. .\" local changes with SGI changes easier for users.
  142. .\"
  143. .fp 4 HD
  144. This section lists installed files that can be edited to contain
  145. site-specific changes.
  146. Please see the server manual pages for complete details.
  147. .P
  148. The following configuration files determine if one or more
  149. facsimile server processes are started during system initialization.
  150. The facsimile system is enabled if the configuration flag
  151. in the \f2/etc/config\fP directory is in the ``on'' state.
  152. Use the \f2chkconfig\fP(1M) command to turn a flag on or off.
  153. .VL 10
  154. .LI "\f2/etc/config/fax\fP"
  155. Start a \f2faxd\fP(1M) process for each configured modem.
  156. .LE
  157. .P
  158. Change the following files to reflect your site's setup:
  159. .VL 10
  160. .LI "\f2/usr/spool/fax/etc/config.\fPfoo"
  161. The configuration file for the /dev/\f2foo\fP modem device.
  162. This file contains information such as the phone number associated
  163. with the modem, and whether or not the server should permit
  164. incoming data connections.
  165. Consult \f2faxaddmodem\fP(1M) and
  166. \f2config\fP(4F) for complete information.
  167. .LI "\f2/usr/spool/fax/\s-1FIFO\s+1.\fPfoo"
  168. This is a \s-1FIFO\s+1 special file that must exist for each modem device
  169. attached to a host.
  170. The file is normally create with mode 600 and owned by user ``uucp''.
  171. The system startup script will create a fax server process for
  172. each device that has both a configuration file and a \s-1FIFO\s+1
  173. special device file.
  174. The installation procedure for a server uses the
  175. \f2faxaddmodem\fP(1M) script to setup this file and
  176. the configuration file.
  177. .LE
  178. .P
  179. The following files may be modified to suit site-specific needs:
  180. .VL 10
  181. .LI "\f2/usr/local/lib/fax/typerules\fP"
  182. A set of rules that specify how to convert a file submitted for
  183. transmission to a format supported by the facsimile server (PostScript
  184. or \s-1TIFF/F\s+1).
  185. Consult \f2typerules\fP(4F) for a description of this file.
  186. .LI "\f2/usr/local/lib/fax/faxcover.ps\fP"
  187. A stylized PostScript document that is used
  188. when creating cover pages for outgoing facsimile.
  189. See the \f2faxcover\fP(1) program for details on the format.
  190. .LI "\f2/usr/spool/fax/bin/notify\fP"
  191. The shell script that is used by the server to notify users
  192. of job status changes.
  193. The default script sends electronic mail to the user that submitted the job.
  194. .LI "\f2/usr/spool/fax/bin/faxrcvd\fP"
  195. The shell script that is invoked by the server when a facsimile
  196. is received.
  197. The default script sends electronic mail to the ``FaxMaster'' user.
  198. .LI "\f2/usr/spool/fax/bin/pollrcvd\fP"
  199. The shell script that is invoked by the server when a facsimile
  200. is received due to a poll operation.
  201. The default script delivers the facsimile by electronic mail.
  202. .LI "\f2/usr/spool/fax/bin/ps2fax\fP"
  203. The shell script that is used by the server to convert a PostScript document
  204. to a \s-1TIFF\s+1 document for transmission.
  205. The default script invokes a Display PostScript-based imaging program.
  206. This file is usually a link to either \f2/usr/spool/fax/bin/ps2fax.dps\fP
  207. or \f2/usr/spool/fax/bin/ps2fax.gs\fP.
  208. .LE
  209. .H 2 "Other Installation Information"
  210. [\fBIf you are unfamiliar with the terminology used in the following
  211. description, refer to the document
  212. \f2/usr/local/doc/flexfax/modems-faq\fP.\f1]
  213. .P
  214. Note that you need a fax modem to use this software.
  215. Fax modems are not the same as data modems,
  216. though many of contemporary fax modems also
  217. function well as data modems.
  218. The modems listed in the introduction 
  219. are known to work with this release (though some perform
  220. better than others).
  221. This software tries to support any facsimile modem
  222. that provides either the
  223. Telecommunications Industry Associate (TIA)
  224. Standards Proposal No. 2388-A of August 30, 1991\(emso called
  225. ``\f2Class 2-style\fP modems''\(emor the
  226. Telecommunications Industry Associate (TIA)
  227. Standard 578 of October 22, 1990\(emso called
  228. ``\f2Class 1-style\fP modems''.
  229. .P
  230. With the executables installed and the appropriate system configuration
  231. information setup, the modem must be prepared for use:
  232. .P
  233. First.  Make sure that your modem works.  One can not say this enough.
  234. If you can not use cu, tip, uucp, or some similar program
  235. to communicate with your modem, do not
  236. try to configure the modem for use with \*(FF.  This means in
  237. particular that you should verify that you have a working cable between
  238. your host and modem and that this cable is suitable for use.  That is,
  239. that the cable has the relevant signals for doing hardware flow control
  240. if that is necessary and that it passes the \s-1DCD\s+1 and \s-1DTR\s+1 signals
  241. appropriately.  On Silicon Graphics
  242. Indigo systems you \fBcan not use a Macintosh cable
  243. to connect your modem\fP.  Once again, repeat after me, ``\fByou can not use a
  244. Macintosh cable to connect your modem to a Silicon Graphics Indigo\fP.''
  245. It may look like it works, but the moment that you try to use hardware flow control
  246. (i.e. \s-1RTS/CTS\s+1) the data will be garbled and you will encounter
  247. problems.  Consult the \f2serial\fP(7) manual page for an
  248. explanation of how to wire up modem cables.  Note also that
  249. the tty port name selected for a modem must reflect whether
  250. hardware or software (\s-1XON/XOFF\s+1) flow control is to be used\(emttyf*
  251. devices use \s-1RTS/CTS\s+1 flow control and ttym* devices use \s-1XON/XOFF\s+1 flow
  252. control.  The rules to use for selecting a flow control method are:
  253. .BL
  254. .LI
  255. If you have a Class 1 modem, then you can use either hardware or
  256. software flow control, but beware of using hardware flow control
  257. as the Class 1 specification only requires vendors to support
  258. software flow control (and some of the Class 1 modems tried so far
  259. do not support hardware flow control).
  260. .LI
  261. If you have a Class 2 or 2.0 modem, then you can use either hardware or
  262. software flow control, but if you are going to communicate with the
  263. modem faster than 9600 baud then you should probably use hardware
  264. flow control.
  265. .LI
  266. If you have an Abaton 24/96 modem, then you must use software flow
  267. control (the driver does not support hardware flow control).
  268. .LE
  269. .P
  270. There are gotchas that you can expect to run into on most any system
  271. when trying to interface to the system's serial port handling.  Consult
  272. Chapter 7 of this document and the manual pages.
  273. .P
  274. With the executables installed and your modem happily connected to the
  275. host with a proper cable, you can add modems with the \f2faxaddmodem\fP shell
  276. script.  This is an interactive script that walks you through the
  277. configuration and installation of a new or existing modem.  Note that
  278. even if you have a previous version of this software installed you
  279. should run the faxaddmodem script to update the configuration
  280. information for your modems.  Below is a sample session.  Typed input
  281. appears \f8emboldened\f1 with single carriage return characters indicated
  282. by ``\f8<\s-1CR\s+1>\f1''; all other material is
  283. printed by faxaddmodem.  Note that if your modem is configured to
  284. communicate to the host at fixed baud rate, then you should use the
  285. \-s option; for example ``\-s 38400'' to communicate at 38.4KB.
  286. .sp
  287. .nf
  288. .ft 7
  289. # \f8faxaddmodem\f7
  290. Verifying your system is setup properly for fax service...
  291.  
  292. You do not appear to have a fax user in the password file.
  293. The fax software needs this to work properly, add it [yes]? \f8<\s-1CR\s+1>\f7
  294. Added user "fax" to /etc/passwd.
  295.  
  296. Adding fax user to "/etc/passwd.sgi".
  297.  
  298. There does not appear to be an entry for the fax service either in
  299. the yellow pages database or in the /etc/services file;
  300. should an entry be added to /etc/services [yes]? \f8<\s-1CR\s+1>\f7
  301.  
  302. There is no entry for the fax service in "/usr/etc/inetd.conf";
  303. should one be added [yes]? \f8<\s-1CR\s+1>\f7
  304. Poking inetd so that it re-reads the configuration file.
  305.  
  306. There does not appear to be an entry for the FaxMaster either in
  307. the yellow pages database or in the /usr/lib/aliases file;
  308. should an entry be added to /usr/lib/aliases [yes]? \f8<\s-1CR\s+1>\f7
  309. Users to receive fax-related mail [sam]?  \f8<\s-1CR\s+1>\f7
  310. Rebuilding /usr/lib/aliases database.
  311. 31 aliases, longest 75 bytes, 701 bytes total
  312.  
  313. Done verifying system setup.
  314.  
  315. Serial port that modem is connected to []? \f8ttyf2\f7
  316.  
  317. Ok, time to setup a configuration file for the modem.  The manual
  318. page config(4F) may be useful during this process.  Also be aware
  319. that at any time you can safely interrupt this procedure.
  320.  
  321. No existing configuration, let's do this from scratch.
  322.  
  323. Country code [1]?  \f8<\s-1CR\s+1>\f7
  324. Area code [415]? \f8510\f7
  325. Phone number of fax modem [+1.415.965.7824]? \f8+1 510 526-8781\f7
  326. Long distance dialing prefix [1]? \f8<\s-1CR\s+1>\f7
  327. International dialing prefix [011]? \f8<\s-1CR\s+1>\f7
  328. Dial string rules file [etc/dialrules]? \f8etc/dialrules.sf-ba\f7
  329. Tracing during normal server operation [1]? \f8<\s-1CR\s+1>\f7
  330. Tracing during send and receive sessions [11]? \f8<\s-1CR\s+1>\f7
  331. Protection mode for received facsimile [0600]? \f8644\f7
  332. Protection mode for session logs [0600]? \f8644\f7
  333. Protection mode for ttyf2 [0600]? \f8<\s-1CR\s+1>\f7
  334. Rings to wait before answering [1]? \f8<\s-1CR\s+1>\f7
  335. Modem speaker volume [off]? \f8<\s-1CR\s+1>\f7
  336.  
  337. The server configuration parameters are:
  338.  
  339. AreaCode                510
  340. CountryCode             1
  341. FAXNumber:              +1 510 526-8781
  342. LongDistancePrefix:     1
  343. InternationalPrefix:    011
  344. DialStringRules:        etc/dialrules.sf-ba
  345. ServerTracing:          1
  346. SessionTracing:         11
  347. RecvFileMode:           0644
  348. LogFileMode:            0644
  349. DeviceMode:             0600
  350. RingsBeforeAnswer:      1
  351. SpeakerVolume:          off
  352.  
  353. Are these ok [yes]? \f8n\f7
  354. Country code [1]? \f8<\s-1CR\s+1>\f7
  355. Area code [510]? \f8<\s-1CR\s+1>\f7
  356. Phone number of fax modem [+1 510 526-8781]? \f8<\s-1CR\s+1>\f7
  357. Long distance dialing prefix [1]?  \f8<\s-1CR\s+1>\f7
  358. International dialing prefix [011]?  \f8<\s-1CR\s+1>\f7
  359. Dial string rules file [etc/dialrules.sf-ba]? \f8<\s-1CR\s+1>\f7
  360. Tracing during normal server operation [1]?  \f8<\s-1CR\s+1>\f7
  361. Tracing during send and receive sessions [11]? \f83\f7
  362. Protection mode for received facsimile [0644]? \f8<\s-1CR\s+1>\f7
  363. Protection mode for session logs [0644]? \f8<\s-1CR\s+1>\f7
  364. Protection mode for ttyf2 [0600]? \f8<\s-1CR\s+1>\f7
  365. Rings to wait before answering [1]? \f8<\s-1CR\s+1>\f7
  366. Modem speaker volume [off]? \f8<\s-1CR\s+1>\f7
  367.  
  368. The server configuration parameters are:
  369.  
  370. AreaCode                510
  371. CountryCode             1
  372. FAXNumber:              +1 510 526-8781
  373. LongDistancePrefix:     1
  374. InternationalPrefix:    011
  375. DialStringRules:        etc/dialrules.sf-ba
  376. ServerTracing:          1
  377. SessionTracing:         3
  378. RecvFileMode:           0644
  379. LogFileMode:            0644
  380. DeviceMode:             0600
  381. RingsBeforeAnswer:      1
  382. SpeakerVolume:          off
  383.  
  384. Are these ok [yes]? \f8<\s-1CR\s+1>\f7
  385.  
  386. Now we are going to probe the tty port to figure out the type
  387. of modem that is attached.  This takes a few seconds, so be patient.
  388. Note that if you do not have the modem cabled to the port, or the
  389. modem is turned off, this may hang (just go and cable up the modem
  390. or turn it on, or whatever).
  391.  
  392. This modem looks to have support for both Class 1 and 2;
  393. how should it be configured [2]? \f8<\s-1CR\s+1>\f7
  394.  
  395. Hmm, this looks like a Class 2 modem.
  396. Modem manufacturer is "AT&T Paradyne EDC".
  397. Modem model is "3710-A2-203".
  398.  
  399. Using prototype configuration file config.att-dataport-2...
  400.  
  401. The modem configuration parameters are:
  402.  
  403. ModemDialCmd:           DT%s
  404. ModemFlowControl:       rtscts
  405. ModemFlowControlCmd:    &R0\eD1\eQ3
  406. ModemRate:              38400
  407. ModemRecvFillOrder:     MSB2LSB
  408. ModemSendFillOrder:     LSB2MSB
  409. ModemSetupAACmd:        +FAA=1
  410. ModemSetupDCDCmd:       &C1
  411. ModemSetupDTRCmd:       &D2
  412. Class2DCCQueryCmd:      "!(0,1),(0-5),(0-4),(0-2),(0),(0),(0),(0-7)"
  413.  
  414. Are these ok [yes]? \f8<\s-1CR\s+1>\f7
  415. Creating new configuration file "/usr/spool/fax/etc/config.ttyf2".
  416. Creating "/usr/spool/fax/FIFO.ttyf2" in the spooling directory.
  417. Done setting up the modem configuration.
  418.  
  419. Startup a facsimile server for this modem [yes] \f8<\s-1CR\s+1>\f7
  420. /usr/etc/faxd -m /dev/ttyf2&
  421. # 
  422. .fi
  423. .ft 1
  424. .P
  425. That's all there is to it (or at least all there \fIshould\fP be to it)!
  426. You can also run faxaddmodem at a later time if you want to reconfigure
  427. your modem.
  428. .P
  429. Beware that when the fax server process runs it normally keeps the
  430. modem in a state suitable for sending and receiving facsimile.  This
  431. may have implications for data communication programs such as tip, cu,
  432. and uucp.  For example, if a Class 2 modem is being used, it may be
  433. necessary to force the modem into Class 0 (for data communication) when
  434. placing a call\(eme.g \s-1AT+FCLASS=0DT\s+1<phone number>.  Alternatively, you
  435. can fiddle with the configuration parameters and keep the modem setup
  436. for data use when the server is not actively using the modem.
  437. .H 2 "Server Operation"
  438. In normal operation configured facsimile servers should be started when
  439. the system is booted and stay around so long as the system is running.
  440. The normal installation process sets up the appropriate
  441. configuration information for servers to be started up by init.
  442. If you need to start a server by
  443. hand, consult the \f2faxd\fP\|(1M) manual page.
  444. .P
  445. Incoming facsimile are placed in the \f2recvq\fP subdirectory of the spooling
  446. area and probably will need to be cleaned up periodically.  Likewise
  447. there is logging information in the \f2log\fP subdirectory and accounting
  448. information in the \f2etc\fP subdirectory of the spooling area that may need
  449. some attention.  The \f2faxcron\fP script is designed to handle the
  450. periodic maintenance of the spooling area.  This script is designed to
  451. be run from \f2cron\fP\|(1) every day; see \f2faxcron\fP\|(1M)
  452. for detailed information on its operation.
  453. If you want to do accounting check out the shell
  454. scripts \f2xferstats\fP\|(1M) and \f2recvstats\fP\|(1M)
  455. for a basic attack on how to process the \f2xferlog\fP
  456. accounting file maintained for facsimile
  457. transmissions and receptions (see also \f2xferlog\fP\|(1M)).
  458. Otherwise the only matter to be concerned with is the support for data
  459. connections.  If your modems are capable of differentiating data
  460. connections from facsimile connections the fax server can invoke a
  461. getty process and permit incoming data connections.  Alternatively, if
  462. your modem does not support an adaptive answer facility, but it is a
  463. Class 1 modem, the server may be able to do adaptive answering in
  464. software.  In any event, beware that if you enable data connections you
  465. should take the normal precautions you would take when there are dialup
  466. ports on your machine.  Specifically, make sure that you have
  467. passwords, appropriate file protections, and proper configuration of
  468. uucp or similar.
  469. .P
  470. If you encounter problems with sending or receiving facsimile you can
  471. enable copious tracing information by editing the configuration
  472. files.  Consult the Troubleshooting chapter and the \f2config\fP\|(4F) and
  473. \f2log\fP\|(4F) manual pages.
  474. .H 2 "Adaptive-answering Strategies"
  475. If your modem supports a good adaptive answering facility, then it
  476. should be enabled with the
  477. \f3ModemSetupAACmd\fP
  478. and the server system will
  479. automatically service fax or data calls as appropriate.
  480. .P
  481. If your modem does not support adaptive-answering (i.e. distinguishing
  482. data from fax), then you have several options.  In all cases sending
  483. facsimile is supported without problems.  If you have a Class 1 modem,
  484. then you can request that the server employ a simple adaptive answering
  485. strategy whereby incoming calls are first answered as if they are for a
  486. fax machine and, if that fails, then answered as if they are for a data
  487. modem.  This facility is enabled by specifying something like:
  488. .sp .5
  489. .nf
  490. .ft 7
  491. .ta \w'Class1RecvIdentTimer:  'u +\w'H+FCLASS=0;A    'u
  492. AdaptiveAnswer:    yes        # enable adaptive answer
  493. ModemAnswerCmd:    +FCLASS=1;A    # default is to answer as fax
  494. ModemAnswerDataCmd:    H+FCLASS=0;A    # hangup and answer as data
  495. Class1RecvIdentTimer: 10000        # timeout fax answer in 10 secs
  496. .ft 1
  497. .fi
  498. .P
  499. in the configuration file.   The above lines cause the fax server to do
  500. the following in response to an incoming phone call:
  501. .AL 1 +5
  502. .LI
  503. Issue "\s-1AT+FCLASS=1;A\s+1" to answer the phone call in Class 1;
  504. i.e. as a fax machine (issuing \s-1CNG\s+1 tones).
  505. .LI
  506. Send \s-1TSI\s+1 and \s-1DIS\s+1 frames as required by the fax protocol.
  507. .LI
  508. Wait for \s-1DCS\s+1 from the caller (if it is a fax machine).
  509. .LI
  510. Timeout waiting for \s-1DCS\s+1 in 10 seconds (or whatever is specified
  511. for \f3Class1RecvIdentTimer\fP).
  512. .LI
  513. Issue "\s-1ATH+FCLASS=0;A\s+1" to hangup and then re-answer the phone
  514. in Class 0; i.e. as a data modem.
  515. .LE
  516. .P
  517. This technique assumes many things about the capabilities of the modem
  518. and the local telephony service and may not work for all Class 1 modems
  519. or for all locales.
  520. .P
  521. A second facility supported by the fax server in lieu of adaptive
  522. answering is a ``rotary of answering techniques''.  The general idea is
  523. that a list of alternative ways to answer the phone is supplied and the
  524. server will rotate through the list until it finds one that works.  For
  525. example, one might specify something like:
  526. .sp .5
  527. .ta \w'AnswerRotary:    'u
  528. .ft 7
  529. AnswerRotary: "fax data"
  530. .ft 1
  531. .sp .5
  532. which would instruct the server to answer incoming calls as if they
  533. were from a fax machine until a call was received from something other
  534. than a fax machine, in which case it would then answer subsequent calls
  535. as a data modem until a non-data call was received (in which case it
  536. would go back to fax).  The rotary list can have up to three items,
  537. with items being selected from one of: fax, data, voice, and any
  538. (answer a call of an unknown type).  The voice answering request is
  539. reserved for future development.  Finally, in conjunction with the
  540. rotary answer facility there is an \f3AnswerBias\fP parameter that can be
  541. used to specify an index into the rotary list to use after
  542. \fIsuccessfull\fP calls.  In the above example, this parameter can be used,
  543. to force calls to always be answered first as data by specifying:
  544. .sp .5
  545. .ft 7
  546. .nf
  547. .ta \w'AnswerRotary:    'u
  548. AnswerRotary:    "fax data"
  549. AnswerBias:    1
  550. .fi
  551. .ft 1
  552. .in -.5i
  553. .H 2 "Non-adaptive-answering Strategies"
  554. If you want to always process incoming calls as fax connections, then
  555. you do not need to do anything; this is the normal setup.  If you want
  556. to always process incoming calls as data connections, then you should
  557. setup your modem configuration so that the \f3ModemAnswerCmd\fP parameter in
  558. the configuration file causes the phone to be answered strictly as a
  559. data modem.  For example, if you have a Class 1 or Class 2 modem, the
  560. following should do this:
  561. .sp .5
  562. .ta \w'AnswerRotary:    'u
  563. .ft 7
  564. ModemAnswerCmd:    +FCLASS=0;A
  565. .ft 1
  566. .sp .5
  567. (this sets the modem into class 0 and then answers the phone).  Another
  568. possibility that you might opt for (especially if your modem is on a
  569. phone line shared with a telephone) is to disable automatic answering
  570. of the phone by setting the \f3RingsBeforeAnswer\fP parameter to zero:
  571. .sp .5
  572. .ta \w'AnswerRotary:    'u
  573. .ft 7
  574. RingsBeforeAnswer:    0
  575. .ft 1
  576. .sp .5
  577. and then use the faxanswer program to explicitly request that the fax
  578. server pick up the phone.  Note that by using the \-h option to \f2faxanswer\fP
  579. you can control whether the fax server answers a phone call as fax,
  580. or data (answering as voice is also supported for compatibility with
  581. future work).
  582.